NAVNavbar
Logo
php python csharp java

Keyword Database

‌‌
Keyword Database encompassed over 3 billion search terms enriched with related data: search volume trends, cpc, competition, impressions, and more.

This database is available in both JSON and CSV formats.

The above command returns JSON structured like this:

{
  "keyword": "personal fashion consultant",
  "location": 2840,
  "language": "en",
  "spell": null,
  "spell_type": null,
  "keyword_info": {
    "search_volume": 30,
    "cpc": 3.711598,
    "competition": 0.29761904761904767,
    "time_update": "03/30/2020 01:11:19",
    "categories": [
      10002,
      10005,
      10013,
      10029,
      10054,
      10055,
      10233,
      10339,
      11414,
      13636
    ],
    "history": {
      "201902": 20,
      "201903": 40,
      "201904": 30,
      "201905": 40,
      "201906": 20,
      "201907": 20,
      "201908": 30,
      "201909": 30,
      "201910": 30,
      "201911": 40,
      "201912": 50,
      "202001": 40,
      "202002": 40
    }
  },
  "impressions_info": {
    "ad_position_avg": 1.91,
    "ad_position_min": 2.1,
    "ad_position_max": 2,
    "cpc_avg": 191.07,
    "cpc_min": 171.97,
    "cpc_max": 210.18,
    "daily_impressions_avg": 1.37,
    "daily_impressions_min": 1.23,
    "daily_impressions_max": 1.5,
    "daily_clicks_avg": 0.04,
    "daily_clicks_min": 0.03,
    "daily_clicks_max": 0.04,
    "bid": 999,
    "daily_cost_avg": 7.32,
    "daily_cost_min": 6.59,
    "daily_cost_max": 8.05,
    "time_update": "04/03/2020 10:30:54"
  }
},
{
  "keyword": "dubai atlantis waterpark",
  "location": 2840,
  "language": "en",
  "spell": null,
  "spell_type": null,
  "keyword_info": {
    "search_volume": 720,
    "cpc": 2.02276,
    "competition": 0.05225726654298083,
    "time_update": "05/02/2020 00:01:13",
    "categories": [
      10017,
      10142,
      10145,
      10769,
      12067,
      13496,
      13582
    ],
    "history": {
      "201901": 480,
      "201902": 390,
      "201903": 390,
      "201904": 480,
      "201905": 390,
      "201906": 590,
      "201907": 880,
      "201908": 880,
      "201909": 720,
      "201910": 720,
      "201911": 720,
      "201912": 880,
      "202001": 720,
      "202002": 720,
      "202003": 480
    }
  },
  "impressions_info": {
    "ad_position_avg": 1.06,
    "ad_position_min": 1.11,
    "ad_position_max": 1,
    "cpc_avg": 1.88,
    "cpc_min": 1.7,
    "cpc_max": 2.07,
    "daily_impressions_avg": 0,
    "daily_impressions_min": 0,
    "daily_impressions_max": 0,
    "daily_clicks_avg": 0,
    "daily_clicks_min": 0,
    "daily_clicks_max": 0,
    "bid": 999,
    "daily_cost_avg": 0,
    "daily_cost_min": 0,
    "daily_cost_max": 0,
    "time_update": "05/01/2020 05:26:42"
  }
}

Description of the fields in the Keyword Database:

Field name Type Description
keyword string keyword
UTF-8 encoding applies
location integer location code
unique identifier of the corresponding location
you can receive the list of available locations with their location_code by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
example:
2840 corresponds to the United States
language string language code
unique identifier of the language available for the corresponding location
you can receive the list of available locations with their language_code by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
example:
en corresponds to English
spell string autocorrection of the search engine
if the search engine provided results for a keyword that was corrected, we will provide the keyword corrected by the search engine and the type of autocorrection
spell_type string type of autocorrection
possible values:
did_you_mean, showing_results_for, no_results_found_for
keyword_info array keyword data for the returned keyword
    search_volume integer average monthly search volume rate
represents either the approximate number of searches for the given keyword idea on google.com or google.com and partners, depending on the user’s targeting
    cpc float cost-per-click
represents the average cost per click (USD) historically paid for the keyword
    competition float competition
represents the relative amount of competition associated with the given keyword;
the value is based on Google Ads data and can be between 0 and 1 (inclusive)
    time_update string date and time when keyword data was last updated
in the format: “month/date/year hours:minutes:seconds UTC”
example:
05/08/2020 09:47:05
    categories array product and service categories
you can download the full list of possible categories
    history array monthly searches
represents the (approximate) number of searches on the returned keyword in the given location
impressions_info array impressions data for the returned keyword
    ad_position_average float the average ad position
represents the average position of the paid result in Google SERP for the returned keyword
    ad_position_min float the minimum ad position
represents the minimum position of the paid result in Google SERP for the returned keyword
    ad_position_max float the maximum ad position
represents the maximum position of the paid result in Google SERP for returned keyword
    cpc_avg float the average value of cost-per-click
represents the average cost-per-click (USD) historically paid for the keyword in Google Ads
    cpc_min float the minimum value of cost-per-click
represents the minimum cost-per-click (USD) historically paid for the keyword in Google Ads
    cpc_max float the maximum value of cost-per-click
represents the maximum cost-per-click (USD) historically paid for the keyword in Google Ads
    daily_impressions_avg float the average value of daily impressions
represents the average number of daily impressions of the paid result in Google SERP for the returned keyword
    daily_impressions_min float the minimum value of daily impressions
represents the minimum number of daily impressions of the paid result in Google SERP for the returned keyword
    daily_impressions_max float the maximum value of daily impressions
represents the maximum number of daily impressions of the paid result in Google SERP for the returned keyword
    daily_clicks_avg float the average value of daily clicks
represents the average number of daily clicks on the paid result in Google SERP for the returned keyword
    daily_clicks_min float the minimum value of daily clicks
represents the minimum number of daily clicks on the paid result in Google SERP for the returned keyword
    daily_clicks_max float the maximum value of daily clicks
represents the maximum number of daily clicks on the paid result in Google SERP for the returned keyword
    bid integer the maximum bid
we return the results for the 999 bid value to provide the most relevant impressions data
    daily_cost_avg float the average daily cost
represents the average daily cost of running ads for the returned keyword in Google Ads
    daily_cost_min float the minimum daily cost
represents the minimum daily cost of running ads for the returned keyword in Google Ads
    daily_cost_max float the maximum daily charge value
represents the maximum daily cost of running ads for the returned keyword in Google Ads
    time_update string date and time when keyword data was last updated
in the format: “month/date/year hours:minutes:seconds UTC”
example:
05/08/2020 09:47:05

‌‌